home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cato / Xm / XmScale.z / XmScale
Encoding:
Text File  |  2002-10-03  |  40.4 KB  |  529 lines

  1.  
  2.  
  3.  
  4.      XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))               UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV               XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmSSSSccccaaaalllleeee - The Scale widget class
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           ####iiiinnnncccclllluuuuddddeeee <<<<XXXXmmmm////SSSSccccaaaalllleeee....hhhh>>>>
  13.  
  14.  
  15.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  16.           This page documents version 1.2 of the Motif library.
  17.  
  18.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.           Scale is used by an application to indicate a value from
  20.           within a range of values, and it allows the user to input or
  21.           modify a value from the same range.
  22.  
  23.           A Scale has an elongated rectangular region similar to a
  24.           ScrollBar.  A slider inside this region indicates the
  25.           current value along the Scale.  The user can also modify the
  26.           Scale's value by moving the slider within the rectangular
  27.           region of the Scale.  A Scale can also include a label set
  28.           located outside the Scale region.  These can indicate the
  29.           relative value at various positions along the scale.
  30.  
  31.           A Scale can be either input/output or output only.  An
  32.           input/output Scale's value can be set by the application and
  33.           also modified by the user with the slider.  An output-only
  34.           Scale is used strictly as an indicator of the current value
  35.           of something and cannot be modified interactively by the
  36.           user.  The CCCCoooorrrreeee resource XXXXmmmmNNNNsssseeeennnnssssiiiittttiiiivvvveeee specifies whether the
  37.           user can interactively modify the Scale's value.
  38.  
  39.           The user can specify resources in a resource file for the
  40.           automatically created gadget that contains the title of the
  41.           Scale widget.  The name of the gadget is "Title".
  42.  
  43.         CCCCllllaaaasssssssseeeessss
  44.           Scale inherits behavior and resources from CCCCoooorrrreeee, CCCCoooommmmppppoooossssiiiitttteeee,
  45.           CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt, and XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr classes.
  46.  
  47.           The class pointer is xxxxmmmmSSSSccccaaaalllleeeeWWWWiiiiddddggggeeeettttCCCCllllaaaassssssss.
  48.  
  49.           The class name is XXXXmmmmSSSSccccaaaalllleeee.
  50.  
  51.         NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss
  52.           The following table defines a set of widget resources used
  53.           by the programmer to specify data.  The programmer can also
  54.           set the resource values for the inherited classes to set
  55.           attributes for this widget.  To reference a resource by name
  56.           or by class in a .Xdefaults file, remove the XXXXmmmmNNNN or XXXXmmmmCCCC
  57.           prefix and use the remaining letters.  To specify one of the
  58.           defined values for a resource in a .Xdefaults file, remove
  59.           the XXXXmmmm prefix and use the remaining letters (in either
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))               UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV               XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))
  71.  
  72.  
  73.  
  74.           lowercase or uppercase, but include any underscores between
  75.           words).  The codes in the access column indicate if the
  76.           given resource can be set at creation time (C), set by using
  77.           XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss (S), retrieved by using XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss (G), or is
  78.           not applicable (N/A).
  79.  
  80.                                       XXXXmmmmSSSSccccaaaalllleeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  81.      NNNNaaaammmmeeee                      CCCCllllaaaassssssss                    TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt      AAAAcccccccceeeessssssss
  82.      _______________________________________________________________________________________
  83.      XmNdecimalPoints          XmCDecimalPoints         short            0            CSG
  84.      XmNdragCallback           XmCCallback              XtCallbackList   NULL         C
  85.      XmNfontList               XmCFontList              XmFontList       dynamic      CSG
  86.      XmNhighlightOnEnter       XmCHighlightOnEnter      Boolean          False        CSG
  87.      XmNhighlightThickness     XmCHighlightThickness    Dimension        2            CSG
  88.      XmNmaximum                XmCMaximum               int              100          CSG
  89.      XmNminimum                XmCMinimum               int              0            CSG
  90.      XmNorientation            XmCOrientation           unsigned char    XmVERTICAL   CSG
  91.      XmNprocessingDirection    XmCProcessingDirection   unsigned char    dynamic      CSG
  92.      XmNscaleHeight            XmCScaleHeight           Dimension        0            CSG
  93.      XmNscaleMultiple          XmCScaleMultiple         int              dynamic      CSG
  94.      XmNscaleWidth             XmCScaleWidth            Dimension        0            CSG
  95.      XmNshowValue              XmCShowValue             Boolean          False        CSG
  96.      XmNtitleString            XmCTitleString           XmString         NULL         CSG
  97.      XmNvalue                  XmCValue                 int              dynamic      CSG
  98.      XmNvalueChangedCallback   XmCCallback              XtCallbackList   NULL         C
  99.  
  100.  
  101.           XXXXmmmmNNNNddddeeeecccciiiimmmmaaaallllPPPPooooiiiinnnnttttssss
  102.                     Specifies the number of decimal points to shift
  103.                     the slider value when displaying it.  For example,
  104.                     a slider value of 2,350 and an XXXXmmmmddddeeeecccciiiimmmmaaaallllPPPPooooiiiinnnnttttssss
  105.                     value of 2 results in a display value of 23.50.
  106.                     The value must not be negative.
  107.  
  108.           XXXXmmmmNNNNddddrrrraaaaggggCCCCaaaallllllllbbbbaaaacccckkkk
  109.                     Specifies the list of callbacks that is called
  110.                     when the slider position changes as the slider is
  111.                     being dragged.  The reason sent by the callback is
  112.                     XXXXmmmmCCCCRRRR____DDDDRRRRAAAAGGGG.
  113.  
  114.           XXXXmmmmNNNNffffoooonnnnttttLLLLiiiisssstttt
  115.                     Specifies the font list to use for the title text
  116.                     string specified by XXXXmmmmNNNNttttiiiittttlllleeeeSSSSttttrrrriiiinnnngggg, and the label
  117.                     displayed when XXXXmmmmNNNNsssshhhhoooowwwwVVVVaaaalllluuuueeee is True.  If this
  118.                     value is NULL at initialization, the font list is
  119.                     initialized by looking up the parent hierarchy of
  120.                     the widget for an ancestor that is a subclass of
  121.                     the XmBulletinBoard, VendorShell, or XmMenuShell
  122.                     widget class.  If such an ancestor is found, the
  123.                     font list is initialized to the XXXXmmmmNNNNllllaaaabbbbeeeellllFFFFoooonnnnttttLLLLiiiisssstttt
  124.                     of the ancestor widget.  If no such ancestor is
  125.                     found, the default is implementation dependent.
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))               UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV               XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))
  137.  
  138.  
  139.  
  140.                     Refer to XXXXmmmmFFFFoooonnnnttttLLLLiiiisssstttt((((3333XXXX)))) for more information on
  141.                     the creation and structure of a font list.
  142.  
  143.           XXXXmmmmNNNNhhhhiiiigggghhhhlllliiiigggghhhhttttOOOOnnnnEEEEnnnntttteeeerrrr
  144.                     Specifies whether the highlighting rectangle is
  145.                     drawn when the cursor moves into the widget.  If
  146.                     the shell's focus policy is XXXXmmmmEEEEXXXXPPPPLLLLIIIICCCCIIIITTTT, this
  147.                     resource is ignored, and the widget is highlighted
  148.                     when it has the focus.  If the shell's focus
  149.                     policy is XXXXmmmmPPPPOOOOIIIINNNNTTTTEEEERRRR and if this resource is True,
  150.                     the highlighting rectangle is drawn when the the
  151.                     cursor moves into the widget.  If the shell's
  152.                     focus policy is XXXXmmmmPPPPOOOOIIIINNNNTTTTEEEERRRR and if this resource is
  153.                     False, the highlighting rectangle is not drawn
  154.                     when the the cursor moves into the widget.  The
  155.                     default is False.
  156.  
  157.           XXXXmmmmNNNNhhhhiiiigggghhhhlllliiiigggghhhhttttTTTThhhhiiiicccckkkknnnneeeessssssss
  158.                     Specifies the size of the slider's border drawing
  159.                     rectangle used for enter window and traversal
  160.                     highlight drawing.
  161.  
  162.           XXXXmmmmNNNNmmmmaaaaxxxxiiiimmmmuuuummmm
  163.                     Specifies the slider's maximum value.  XXXXmmmmNNNNmmmmaaaaxxxxiiiimmmmuuuummmm
  164.                     must be greater than XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmm.
  165.  
  166.           XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmm
  167.                     Specifies the slider's minimum value.  XXXXmmmmNNNNmmmmaaaaxxxxiiiimmmmuuuummmm
  168.                     must be greater than XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmm.
  169.  
  170.           XXXXmmmmNNNNoooorrrriiiieeeennnnttttaaaattttiiiioooonnnn
  171.                     Displays Scale vertically or horizontally.  This
  172.                     resource can have values of XXXXmmmmVVVVEEEERRRRTTTTIIIICCCCAAAALLLL aaaannnndddd
  173.                     XXXXmmmmHHHHOOOORRRRIIIIZZZZOOOONNNNTTTTAAAALLLL.
  174.  
  175.           XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn
  176.                     Specifies whether the value for XXXXmmmmNNNNmmmmaaaaxxxxiiiimmmmuuuummmm is on
  177.                     the right or left side of XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmm for
  178.                     horizontal Scales or above or below XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmm for
  179.                     vertical Scales.  This resource can have values of
  180.                     XXXXmmmmMMMMAAAAXXXX____OOOONNNN____TTTTOOOOPPPP,,,, XXXXmmmmMMMMAAAAXXXX____OOOONNNN____BBBBOOOOTTTTTTTTOOOOMMMM,,,,XXXXmmmmMMMMAAAAXXXX____OOOONNNN____LLLLEEEEFFFFTTTT, and
  181.                     XXXXmmmmMMMMAAAAXXXX____OOOONNNN____RRRRIIIIGGGGHHHHTTTT.  If the XmScale is oriented
  182.                     vertically, the default value is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____TTTTOOOOPPPP.  If
  183.                     the XmScale is oriented horizontally, the default
  184.                     value may depend on the value of the
  185.                     XXXXmmmmNNNNssssttttrrrriiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn resource.
  186.  
  187.           XXXXmmmmNNNNssssccccaaaalllleeeeHHHHeeeeiiiigggghhhhtttt
  188.                     Specifies the height of the slider area.  The
  189.                     value should be in the specified unit type (the
  190.                     default is pixels).  If no value is specified a
  191.                     default height is computed.
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 4/30/98)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))               UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV               XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))
  203.  
  204.  
  205.  
  206.           XXXXmmmmNNNNssssccccaaaalllleeeeMMMMuuuullllttttiiiipppplllleeee
  207.                     Specifies the amount to move the slider when the
  208.                     user takes an action that moves the slider by a
  209.                     multiple increment.  The default is (XXXXmmmmNNNNmmmmaaaaxxxxiiiimmmmuuuummmm -
  210.                     XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmm) divided by 10, with a minimum of 1.
  211.  
  212.           XXXXmmmmNNNNssssccccaaaalllleeeeWWWWiiiiddddtttthhhh
  213.                     Specifies the width of the slider area.  The value
  214.                     should be in the specified unit type (the default
  215.                     is pixels).  If no value is specified a default
  216.                     width is computed.
  217.  
  218.           XXXXmmmmNNNNsssshhhhoooowwwwVVVVaaaalllluuuueeee
  219.                     Specifies whether a label for the current slider
  220.                     value should be displayed next to the slider.  If
  221.                     the value is True, the current slider value is
  222.                     displayed.
  223.  
  224.           XXXXmmmmNNNNttttiiiittttlllleeeeSSSSttttrrrriiiinnnngggg
  225.                     Specifies the title text string to appear in the
  226.                     Scale widget window.
  227.  
  228.           XXXXmmmmNNNNvvvvaaaalllluuuueeee  Specifies the slider's current position along the
  229.                     scale, between XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmm and XXXXmmmmNNNNmmmmaaaaxxxxiiiimmmmuuuummmm.  The
  230.                     value is constrained to be within these inclusive
  231.                     bounds.  The initial value of this resource is the
  232.                     larger of 0 and XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmm.
  233.  
  234.           XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk
  235.                     Specifies the list of callbacks that is called
  236.                     when the slider has moved or its value has been
  237.                     changed.  The reason sent by the callback is
  238.                     XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD.
  239.  
  240.  
  241.         IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss
  242.           Scale inherits behavior and resources from the following
  243.           superclasses.  For a complete description of each resource,
  244.           refer to the man page for that superclass.
  245.  
  246.                                           XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  247.      NNNNaaaammmmeeee                    CCCCllllaaaassssssss                   TTTTyyyyppppeeee                DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
  248.      _________________________________________________________________________________________________
  249.      XmNbottomShadowColor    XmCBottomShadowColor    Pixel               dynamic                CSG
  250.      XmNbottomShadowPixmap   XmCBottomShadowPixmap   Pixmap              XmUNSPECIFIED_PIXMAP   CSG
  251.      XmNforeground           XmCForeground           Pixel               dynamic                CSG
  252.      XmNhelpCallback         XmCCallback             XtCallbackList      NULL                   C
  253.      XmNhighlightColor       XmCHighlightColor       Pixel               dynamic                CSG
  254.      XmNhighlightPixmap      XmCHighlightPixmap      Pixmap              dynamic                CSG
  255.      XmNinitialFocus         XmCInitialFocus         Widget              NULL                   CSG
  256.  
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                                          (printed 4/30/98)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))               UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV               XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))
  269.  
  270.  
  271.  
  272.      XmNnavigationType       XmCNavigationType       XmNavigationType    XmTAB_GROUP            CSG
  273.      XmNshadowThickness      XmCShadowThickness      Dimension           2                      CSG
  274.      XmNstringDirection      XmCStringDirection      XmStringDirection   dynamic                CG
  275.      XmNtopShadowColor       XmCTopShadowColor       Pixel               dynamic                CSG
  276.      XmNtopShadowPixmap      XmCTopShadowPixmap      Pixmap              dynamic                CSG
  277.      XmNtraversalOn          XmCTraversalOn          Boolean             True                   CSG
  278.      XmNunitType             XmCUnitType             unsigned char       dynamic                CSG
  279.      XmNuserData             XmCUserData             XtPointer           NULL                   CSG
  280.  
  281.                              CCCCoooommmmppppoooossssiiiitttteeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  282.      NNNNaaaammmmeeee                CCCCllllaaaassssssss               TTTTyyyyppppeeee          DDDDeeeeffffaaaauuuulllltttt   AAAAcccccccceeeessssssss
  283.      ______________________________________________________________________
  284.      XmNchildren         XmCReadOnly         WidgetList    NULL      G
  285.      XmNinsertPosition   XmCInsertPosition   XtOrderProc   NULL      CSG
  286.      XmNnumChildren      XmCReadOnly         Cardinal      0         G
  287.  
  288.                                                    CCCCoooorrrreeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
  289.      NNNNaaaammmmeeee                            CCCCllllaaaassssssss                           TTTTyyyyppppeeee             DDDDeeeeffffaaaauuuulllltttt                AAAAcccccccceeeessssssss
  290.      ______________________________________________________________________________________________________________
  291.      XmNaccelerators                 XmCAccelerators                 XtAccelerators   dynamic                CSG
  292.      XmNancestorSensitive            XmCSensitive                    Boolean          dynamic                G
  293.      XmNbackground                   XmCBackground                   Pixel            dynamic                CSG
  294.      XmNbackgroundPixmap             XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
  295.      XmNborderColor                  XmCBorderColor                  Pixel            XtDefaultForeground    CSG
  296.      XmNborderPixmap                 XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
  297.      XmNborderWidth                  XmCBorderWidth                  Dimension        0                      CSG
  298.      XmNcolormap                     XmCColormap                     Colormap         dynamic                CG
  299.      XmNdepth                        XmCDepth                        int              dynamic                CG
  300.      XmNdestroyCallback              XmCCallback                     XtCallbackList   NULL                   C
  301.      XmNheight                       XmCHeight                       Dimension        dynamic                CSG
  302.      XmNinitialResourcesPersistent   XmCInitialResourcesPersistent   Boolean          True                   C
  303.      XmNmappedWhenManaged            XmCMappedWhenManaged            Boolean          True                   CSG
  304.      XmNscreen                       XmCScreen                       Screen *         dynamic                CG
  305.      XmNsensitive                    XmCSensitive                    Boolean          True                   CSG
  306.      XmNtranslations                 XmCTranslations                 XtTranslations   dynamic                CSG
  307.      XmNwidth                        XmCWidth                        Dimension        dynamic                CSG
  308.      XmNx                            XmCPosition                     Position         0                      CSG
  309.      XmNy                            XmCPosition                     Position         0                      CSG
  310.  
  311.         CCCCaaaallllllllbbbbaaaacccckkkk IIIInnnnffffoooorrrrmmmmaaaattttiiiioooonnnn
  312.           A pointer to the following structure is passed to each
  313.           callback:
  314.  
  315.           ttttyyyyppppeeeeddddeeeeffff ssssttttrrrruuuucccctttt
  316.           {{{{
  317.             iiiinnnntttt      _r_e_a_s_o_n;;;;
  318.             XXXXEEEEvvvveeeennnntttt   * _e_v_e_n_t;;;;
  319.             iiiinnnntttt      _v_a_l_u_e;;;;
  320.           }}}} XXXXmmmmSSSSccccaaaalllleeeeCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt;;;;
  321.  
  322.  
  323.           _r_e_a_s_o_n Indicates why the callback was invoked
  324.  
  325.  
  326.  
  327.      Page 5                                          (printed 4/30/98)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))               UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV               XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))
  335.  
  336.  
  337.  
  338.           _e_v_e_n_t  Points to the XXXXEEEEvvvveeeennnntttt that triggered the callback
  339.  
  340.           _v_a_l_u_e  Is the new slider value
  341.  
  342.  
  343.         BBBBeeeehhhhaaaavvvviiiioooorrrr
  344.           XmScale behavior is described below:
  345.  
  346.  
  347.           BBBBSSSSeeeelllleeeecccctttt PPPPrrrreeeessssssss or BBBBDDDDrrrraaaagggg PPPPrrrreeeessssssss:
  348.                     (in region between an end of the Scale and the
  349.                     slider): Moves the slider by one multiple
  350.                     increment in the direction of the end of the Scale
  351.                     and calls the XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk callbacks.
  352.                     If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____RRRRIIIIGGGGHHHHTTTT or
  353.                     XXXXmmmmMMMMAAAAXXXX____OOOONNNN____BBBBOOOOTTTTTTTTOOOOMMMM, movement toward the right or
  354.                     bottom increments the Scale value, and movement
  355.                     toward the left or top decrements the Scale value.
  356.                     If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____LLLLEEEEFFFFTTTT or
  357.                     XXXXmmmmMMMMAAAAXXXX____OOOONNNN____TTTTOOOOPPPP, movement toward the right or bottom
  358.                     decrements the Scale value, and movement toward
  359.                     the left or top increments the Scale value.  If
  360.                     the button is held down longer than a delay
  361.                     period, the slider is moved again by the same
  362.                     increment and the same callbacks are called.
  363.  
  364.                     (in slider):  Activates the interactive dragging
  365.                     of the slider.
  366.  
  367.           BBBBSSSSeeeelllleeeecccctttt MMMMoooottttiiiioooonnnn or BBBBDDDDrrrraaaagggg MMMMoooottttiiiioooonnnn:
  368.                     If the button press occurs within the slider, the
  369.                     subsequent motion events move the slider to the
  370.                     position of the pointer and call the callbacks for
  371.                     XXXXmmmmNNNNddddrrrraaaaggggCCCCaaaallllllllbbbbaaaacccckkkk.
  372.  
  373.           BBBBSSSSeeeelllleeeecccctttt RRRReeeelllleeeeaaaasssseeee or BBBBDDDDrrrraaaagggg RRRReeeelllleeeeaaaasssseeee:
  374.                     If the button press occurs within the slider, the
  375.                     callbacks for XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk are called.
  376.  
  377.           MMMMCCCCttttrrrrllll BBBBSSSSeeeelllleeeecccctttt PPPPrrrreeeessssssss:
  378.                     ((((iiiinnnn rrrreeeeggggiiiioooonnnn bbbbeeeettttwwwweeeeeeeennnn aaaannnn eeeennnndddd ooooffff tttthhhheeee SSSSccccaaaalllleeee aaaannnndddd tttthhhheeee
  379.                     sssslllliiiiddddeeeerrrr)))): Moves the slider to that end of the Scale
  380.                     and calls the XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk callbacks.
  381.                     If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____RRRRIIIIGGGGHHHHTTTT or
  382.                     XXXXmmmmMMMMAAAAXXXX____OOOONNNN____BBBBOOOOTTTTTTTTOOOOMMMM, movement toward the right or
  383.                     bottom increments the Scale value, and movement
  384.                     toward the left or top decrements the Scale value.
  385.                     If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____LLLLEEEEFFFFTTTT or
  386.                     XXXXmmmmMMMMAAAAXXXX____OOOONNNN____TTTTOOOOPPPP, movement toward the right or bottom
  387.                     decrements the Scale value, and movement toward
  388.                     the left or top increments the Scale value.
  389.  
  390.  
  391.  
  392.  
  393.      Page 6                                          (printed 4/30/98)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))               UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV               XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))
  401.  
  402.  
  403.  
  404.           KKKKUUUUpppp:      For vertical Scales, moves the slider up one
  405.                     increment and calls the XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk
  406.                     callbacks.  If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is
  407.                     XXXXmmmmMMMMAAAAXXXX____OOOONNNN____TTTTOOOOPPPP, movement toward the top increments
  408.                     the Scale value.  If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is
  409.                     XXXXmmmmMMMMAAAAXXXX____OOOONNNN____BBBBOOOOTTTTTTTTOOOOMMMM, movement toward the top
  410.                     decrements the Scale value.
  411.  
  412.           KKKKDDDDoooowwwwnnnn:    For vertical Scales, moves the slider down one
  413.                     increment and calls the XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk
  414.                     callbacks.  If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is
  415.                     XXXXmmmmMMMMAAAAXXXX____OOOONNNN____BBBBOOOOTTTTTTTTOOOOMMMM, movement toward the bottom
  416.                     increments the Scale value.  If
  417.                     XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____TTTTOOOOPPPP, movement
  418.                     toward the bottom decrements the Scale value.
  419.  
  420.           KKKKLLLLeeeefffftttt:    For horizontal Scales, moves the slider one
  421.                     increment to the left and calls the
  422.                     XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk callbacks.  If
  423.                     XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____LLLLEEEEFFFFTTTT, movement
  424.                     toward the left increments the Scale value.  If
  425.                     XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____RRRRIIIIGGGGHHHHTTTT, movement
  426.                     toward the left decrements the Scale value.
  427.  
  428.           KKKKRRRRiiiigggghhhhtttt:   For horizontal Scales, moves the slider one
  429.                     increment to the right and calls the
  430.                     XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk callbacks.  If
  431.                     XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____RRRRIIIIGGGGHHHHTTTT, movement
  432.                     toward the right increments the Scale value.  If
  433.                     XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____LLLLEEEEFFFFTTTT, movement
  434.                     toward the right decrements the Scale value.
  435.  
  436.           MMMMCCCCttttrrrrllll KKKKUUUUpppp or KKKKPPPPaaaaggggeeeeUUUUpppp:
  437.                     For vertical Scales, moves the slider up one
  438.                     multiple increment and calls the
  439.                     XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk callbacks.  If
  440.                     XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____TTTTOOOOPPPP, movement
  441.                     toward the top increments the Scale value.  If
  442.                     XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____BBBBOOOOTTTTTTTTOOOOMMMM,
  443.                     movement toward the top decrements the Scale
  444.                     value.
  445.  
  446.           MMMMCCCCttttrrrrllll KKKKDDDDoooowwwwnnnn or KKKKPPPPaaaaggggeeeeDDDDoooowwwwnnnn:
  447.                     For vertical Scales, moves the slider down one
  448.                     multiple increment and calls the
  449.                     XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk callbacks.  If
  450.                     XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____BBBBOOOOTTTTTTTTOOOOMMMM,
  451.                     movement toward the bottom increments the Scale
  452.                     value.  If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____TTTTOOOOPPPP,
  453.                     movement toward the bottom decrements the Scale
  454.                     value.
  455.  
  456.  
  457.  
  458.  
  459.      Page 7                                          (printed 4/30/98)
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.      XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))               UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV               XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX))))
  467.  
  468.  
  469.  
  470.           MMMMCCCCttttrrrrllll KKKKLLLLeeeefffftttt or KKKKPPPPaaaaggggeeeeLLLLeeeefffftttt:
  471.                     For horizontal Scales, moves the slider one
  472.                     multiple increment to the left and calls the
  473.                     XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk callbacks.  If
  474.                     XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____LLLLEEEEFFFFTTTT, movement
  475.                     toward the left increments the Scale value.  If
  476.                     XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____RRRRIIIIGGGGHHHHTTTT, movement
  477.                     toward the left decrements the Scale value.
  478.  
  479.           MMMMCCCCttttrrrrllll KKKKRRRRiiiigggghhhhtttt or KKKKPPPPaaaaggggeeeeRRRRiiiigggghhhhtttt:
  480.                     For horizontal Scales, moves the slider one
  481.                     multiple increment to the right and calls the
  482.                     XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk callbacks.  If
  483.                     XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____RRRRIIIIGGGGHHHHTTTT, movement
  484.                     toward the right increments the Scale value.  If
  485.                     XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____LLLLEEEEFFFFTTTT, movement
  486.                     toward the right decrements the Scale value.
  487.  
  488.           KKKKBBBBeeeeggggiiiinnnnLLLLiiiinnnneeee or KKKKBBBBeeeeggggiiiinnnnDDDDaaaattttaaaa:
  489.                     Moves the slider to the minimum value and calls
  490.                     the XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk callbacks.
  491.  
  492.           KKKKEEEEnnnnddddLLLLiiiinnnneeee or KKKKEEEEnnnnddddDDDDaaaattttaaaa:
  493.                     Moves the slider to the maximum value and calls
  494.                     the XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk callbacks.
  495.  
  496.           KKKKNNNNeeeexxxxttttFFFFiiiieeeelllldddd:
  497.                     Traverses to the first item in the next tab group.
  498.                     If the current tab group is the last entry in the
  499.                     tab group list, it wraps to the beginning of the
  500.                     tab group list.
  501.  
  502.           KKKKPPPPrrrreeeevvvvFFFFiiiieeeelllldddd:
  503.                     Traverses to the first item in the previous tab
  504.                     group.  If the beginning of the tab group list is
  505.                     reached, it wraps to the end of the tab group
  506.                     list.
  507.  
  508.           KKKKHHHHeeeellllpppp:    Calls the callbacks for XXXXmmmmNNNNhhhheeeellllppppCCCCaaaallllllllbbbbaaaacccckkkk if any
  509.                     exist.  If there are no help callbacks for this
  510.                     widget, this action calls the help callbacks for
  511.                     the nearest ancestor that has them.
  512.  
  513.  
  514.         VVVViiiirrrrttttuuuuaaaallll BBBBiiiinnnnddddiiiinnnnggggssss
  515.           The bindings for virtual keys are vendor specific.  For
  516.           information about bindings for virtual buttons and keys, see
  517.           VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss((((3333XXXX)))).
  518.  
  519.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  520.           CCCCoooommmmppppoooossssiiiitttteeee((((3333XXXX)))), CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt((((3333XXXX)))), CCCCoooorrrreeee((((3333XXXX)))), XXXXmmmmCCCCrrrreeeeaaaatttteeeeSSSSccccaaaalllleeee((((3333XXXX)))),
  521.           XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr((((3333XXXX)))), XXXXmmmmSSSSccccaaaalllleeeeGGGGeeeettttVVVVaaaalllluuuueeee((((3333XXXX)))), and XXXXmmmmSSSSccccaaaalllleeeeSSSSeeeettttVVVVaaaalllluuuueeee((((3333XXXX)))).
  522.  
  523.  
  524.  
  525.      Page 8                                          (printed 4/30/98)
  526.  
  527.  
  528.  
  529.